The Arsenal Files 6/The Arsenal Files 6 (Arsenal Computer).ISO/os2bbs/va1b1-o2.zip/VUUCP.DOC

Text File | 1996-01-28 | 14KB | 341 lines

         VUUCP.EXE 2.00
         ══════════════

                VUUCP.EXE is the UUCP network software provided with
         Virtual Advanced software.  It allows for UUCP type network
         operations with the world-wide Internet.  It might even be used
         to connect to alternative and/or private UUCP type networks.
         VUUCP is complete -- there is no other mailer or software
         needed, and set-up couldn't be simpler.

               Virtual Advanced features an extremely sophisticated
         version of VUUCP.EXE which can gate email between the Internet
         and the other networks, gate newsgroups between the Internet
         and other networks, and can even toss (unpack) mail in
         the background, so it doesn't tie up a serial port/modem.

         VUUCP.EXE COMMAND LINE USAGE
         ════════════════════════════

                Note that <ch> refers to Virtual Advanced Channel Number,
         and that if the NETWORKID= is omitted, NETWORKID=9 is assumed.

         VUUCP <ch> /U NETWORKID=9

         Update any outgoing mail.  Automatically called by VME as needed.

         VUUCP <ch> /R NETWORKID=9

         Pull in data received by remote.
         (Automatically run when data is received after a net call.)

         VUUCP <ch> /D<full system name> NETWORKID=9

         Dial into the specified system.

         VUUCP <ch> /A NETWORKID=9

         Used to handle an incoming UUCP call-in.  Use of this option
         requires script programming.

         VCONFIG SET-UP FOR VUUCP
         ════════════════════════

                When setting up a UUCP based network using VCONFIG, you
         will be given the following choices:

         1. System Address:

         This is where you enter your full Internet address.
         (Example: mybbs.myhost.com)

         2. Spool Directory:

         This setting specifies the directory to be used by this network for
         storage of outgoing mail, and temporary storage for incoming data.
         (Example: C:\SPOOL)

         Directories will be created beneath this directory automatically,
         on an as-needed basis.

         D. Edit Remote List

         This choice lets you edit the list of systems you are connected to.
         Many of you will only have one system in this list -- this one
         system being your Internet Service Provider.  There are 5 settings
         for each remote system you connect with:

         1. System Address

         The full Internet address of the remote system.

         2. Phone Number

         The data phone number, as it needs to be dialed, to call this system.

         3. Wait-For #1

            Send #1

         4. Wait-For #2

            Send #2

         Typically this sequence is used to complete the "Login:" part
         (Wait-For #1/Send #1) and "Password:" part (Wait-For #2/Send #2)
         of the login process during an outgoing net call to a UNIX-based
         host.

         If you connect to a UNIX or Waffle-based UUCP site, you'll need the
         "Wait-For" and "Send" fields to "login" to the remote site when you
         place a net call, sort of like a regular user.

         The difference is that UNIX will detect your account as being a
         systems mail account, and will automatically start-up the UUCP
         mail session as soon as you're logged in.

         (Your account login ID and password are provided to you by your
         Internet Service Provider, and are not related to your Internet
         system address.  Provider's require logins/passwords to prevent
          unauthorized use of your systems mail account, and to facilitate
         billing.)

         Example:

         Wait-For #1: ogin:
         Send #1:     mybbs
         Wait-For #2: word:
         Send #2:     mybbspw

         Waits for the word "ogin:" (as in "Login:" or "login:") and then
         sends "mybbs" plus a carriage return.  Then, waits for the word
         "word:" (as in "Password:" or "password:") and then sends "mybbspw"
         plus a carriage return.

   NOTE: The above login provisions will be sufficient for the vast
         majority of the users of this software.  If you need something
         more complex to login to your Internet/UNIX host, an optional
         login "macro" capability is provided.  See section ADVANCED
         OPTIONS for more information.

         5. Knows *Us* As:

         When you call into an Internet site to pickup your mail, after
         the login/password sequence, your system must identify itself
         to the host.  Some systems require the full Internet address
         (eg "mybbs.win.net").  Most systems, particularly UNIX ones,
         want to see only the first part of our name up to the first
         period, maximum 7 characters, eg "mybbs.win.net" -> "mybbs".

         This field, therefore, controls how *your* system identifies
         itself to this particular remote system during a net callout
         to the remote system.

         By default, VCONFIG will try to "guess" the proper data to put
         into this field whenever you add a new remote system to the remote
         system list.  VCONFIG should guess correctly about 90% of the time.

         The important thing to remember is that different UUCP hosts are
         going to have different requirements for logging into the system
         and then for system identification during the actual network
         identification handshake.

         You should try the VCONFIG-supplied default for this field.
         However, if you receive the message:

         "You are unknown to me"

         during a net-callout, this might be an indication that you need
         to fiddle with this field.  (It could also be an indication that your
         service provider hasn't set-up your UUCP mail account yet!)

         The important thing to remember is that different UUCP hosts are
         going to have different requirements for logging into the system
         and then for system identification during the actual network
         identification handshake.

         If in doubt, contact your service provider; they should be able
         to tell you what is proper to enter for this field.

         SETTING UP EMAIL
         ════════════════

                There is nothing extra you need to do, beyond the initial
         VUUCP set-up described above, to be able to send and receive
         Internet Email.  There is nothing further you must do to be
         able to GATE email to other networks, either.

                Each user, though, must send an initial email to
         "fire up" their Internet email handle.  In other words, the
         first time someone sends mail through VUUCP, a unique
         handle is generated for them so that return replies will
         find them.  It is recommended that they send mail to:

         [e-mail]

         where your.address is replaced by your actual Internet address.
         This mail will be loop-ed back to your BBS without going out
         over the Internet, but will accomplish the task of assigning
         the user a unique handle.

                It is recommended that you set up a VME auto-reply robot
         with the name "mailid," and then your users will actually get back
         the message you want to send them, with their newly-generated
         Internet address showing in the "To:" line of the message.

         SETTING UP INTERNET NEWSGROUPS
         ══════════════════════════════

                Newsgroups can be quickly and easily set-up using the
         included VMB utility program.  Make sure you have ASCII file
         NEWSGRP.9 installed in your DATA directory for VMB to function
         properly.  NEWSGRP.9 is the file containinng the newsgroup
         listings.

                An alternative method to newsgroup set-up is to use
         VCONFIG to manually set-up/edit each database entry.  In this
         case, you would use the DATABASE CONFIGURATION portion of
         VCONFIG to display/edit a DATABASE COFIGURATION ENTRY. At
         this point, selecting the field "(G) Networks Configuration"
         would let you manually do what VMB does automatically.
         A typical newsgroup name looks like:

               alt.bbs
               biz.comp.hardware
               comp.sys.ibm-pc

                To GATE an Internet newsgroup, you merely set-up its
         DATABASE COFIGURATION ENTRY to show that the field
         "(G) Networks Configuration" shows multiple networks --
         Internet, and the other network(s) you want to GATE to/from.
         For example, you might see:

              Internet=alt.bbs
              VirtualNET=100000

         This means that this particular message base is a gateway
         between Internet's alt.bbs newsgroup, and VirtualNET's
         message sub number 100000.

         SETTING UP INTERNET "MAIL-LISTS"
         ════════════════════════════════

                This does not refer to a multi-mailing list.  This refers
         to an Internet Mailing List - a type of message conference
         which is hosted by a particular site.  The host has complete
         control over distribution (who is allowed to join) and
         approval of postings before they get re-distributed to the
         rest of the list membership.

                Although an Internet MAIL-LIST is like a message conference,
         all messages incoming and outgoing are sent as emails.  VUUCP
         handles the conversion for you in both cases.

                Unlike newsgroups, MAIL-LISTs cannot be set-up with VMB.
         You must use VCONFIG to manually set them up.  (See the section
         previous SETTING UP INTERNET NEWSGROUPS for more info on manually
         editing Database Network Configuration.)  A typical configuration
         entry in this case might be:

               VNEWS,virtual.win.net

         Where VNEWS is the name of the MAIL-LIST, and virtual.win.net
         is the host where new posts should be sent.  All MAIL-LIST posts
         are converted to emails when outgoing; our example would send
         the new posts (replies) to [e-mail], where the post
         would be redistributed to other list members from there.

         ADVANCED OPTIONS
         ════════════════

                The features described hereafter are optional, and unneeded
         in most cases.

      *  Extended Login Macro Script

         If you need more versatility to login to your Internet
         Service Provider you must create a text file called MACRO.TXT
         in the storage directory for that particular system.  For example,
         suppose your Spool directory is set to C:\SPOOL, and your
         host is myhost.myprovider.com.  The directory where you would
         place MACRO.TXT is C:\SPOOL\MYHOST (a directory VUUCP
         has automatically created for you already, assuming you've run
         VUUCP at least once since configuration.)

         The format of the MACRO.TXT file ASCII text with one commmand
         per line.   Allowable commands are SEND and WAITFOR, and they use
         the following syntax:

         SEND <string to transmit>

         Examples:

         SEND ThisString

         SEND Hello{

         The SEND command automatically replaces the "{" character with
         a carriage return.

         WAITFOR <waitfor string>,<send string>

         Examples:

         WAITFOR prompt:,myname
         WAITFOR ogin:,mysystem

         With WAITFOR, the string to be sent will have a carriage return
         automatically appended at the end.

         When the last line of MACRO.TXT has been executed, VUUCP proceeds
         to the built-in Waitfor/Send pairs unless you've disabled them.

      *  VUUCP /R command line option

         This function might be used to "import" standard Internet
         Message Format mesages received via a different source/method
         into the BBS.  In other words, you'd copy the files you wanted
         to import into your SPOOL\TMP directory, and simply execute:

         VUUCP 1 /R NETWORKID=9
         VME 1 /TOSS

     *   Using VUUCP to import messages received via Planet Connect

         A special command line option has been added to make importing
         Internet newsfeeds received via Planet Connect as simple as possible.
         The Planet Connect software delivers to you a file with the
         name PCUSENET.xxx where xxx is a sequence number.  Simply copy
         the received PCUSENET.xxx file to your VUUCP SPOOL directory,
         and from your main directory execute:

         VUUCP 1 /PC NETWORKID=9

         IMPORTANT: The PCUSENET.xxx file is a 2.04g ZIP format file,
         and VUUCP will call upon PKUNZIP.EXE to unzip it for you
         automatically.  Make sure you have an accessable 2.04g version
         (or newer) PKUNZIP.EXE!

     *   Troubleshooting

         Still not able to make it work?  Try adding either of the
         following lines to your DATA\NET.9 file.  This is an ASCII
         file which contains your Internet main configuration information.
         You can edit this file with MSDOS EDIT or similar text editor
         or word processor in PLAIN TEXT mode.

         First try:

         debuglevel=2

         And if that doesn't give enough information, try:

         debuglevel=3

         Both will adversely affect program performance, but you will
         get more information in the VUUCP.LOG file for study in solving
         your problem.  These lines should, of course, be removed
         once you've solved the problem.